home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 045a / lstfmt22.zip / LSTFMT22.DOC < prev    next >
Text File  |  1991-09-28  |  39KB  |  1,172 lines
  1.                                   28-SEP-1991
  2.  
  3.  
  4.  
  5.                               LSTFMT Version 2.20
  6.                                          
  7.        A NodeList Output Formatting Utility for FTSC Compliant NodeLists
  8.                            Author: Steven K. Shapiro
  9.                                          
  10.                               SysOp LoneStar CBCS
  11.                                 FidoNet 1:382/35
  12.                                          
  13.                            Program and Documentation
  14.           Copyright (C) 1989, 1990, 1991 SKS Computer Consulting, Inc.
  15.                               All Rights Reserved
  16.                                          
  17.                                          
  18.                                          
  19.                      LSTFMT IS NOT PUBLIC DOMAIN SOFTWARE!
  20.                                          
  21.                         LSTFMT IS COPYRIGHTED SOFTWARE.
  22.                                          
  23.                    YOU ARE ENTITLED TO USE AND DISTRIBUTE THE
  24.                LSTFMT PACKAGE ONLY IN ACCORDANCE WITH THE LICENSE
  25.                           AGREEMENT CONTAINED HEREIN.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                   28-SEP-1991
  67.  
  68.  
  69.  
  70.      LICENSE AGREEMENT, WARRANTY AND STATEMENT OF LIABILITY 
  71.  
  72.      The  term  "the  package"  refers   to   the   LSTFMT   software   and
  73.      documentation,  individually  and collectively.  The term "the author"
  74.      shall be construed to mean Steven K.  Shapiro.  The term "FTSC" refers
  75.      to the FidoNet Technical Standards Committee.  
  76.  
  77.      The package is the exclusive property of the author, and is  protected
  78.      by  copyright  laws.   By  obtaining a copy of the package, you do not
  79.      "own" a copy...all property rights are retained by  the  author.   You
  80.      are merely licensed to USE it.  
  81.  
  82.      This  License  grants limited rights to use and distribute the package
  83.      in accordance with the terms listed herein.  Any other use constitutes
  84.      a violation of the author's rights under United States Copyright  Law,
  85.      and applicable treaties.  
  86.  
  87.      You  may  use the package and/or give copies of the package to others,
  88.      but only in a form that permits inclusion of all files as found in the
  89.      original, archived form in which the package  is  distributed  by  the
  90.      author.  You are not permitted to modify any portion of the package in
  91.      any  way,  including,  but  not limited to adding files to or removing
  92.      files   from   the  distribution  package,  changing  or  editing  the
  93.      documentation,   and/or   changing   or   modifying   the   executable
  94.      program(s).  
  95.  
  96.      If you find the package to  be  of  use,  and  feel  that  a  monetary
  97.      contribution  is  in  order,  you  are encouraged to forward it to the
  98.      author.  
  99.  
  100.      The package is not provided with any warranty of any kind,  including,
  101.      but not limited to fitness for any particular purpose.  
  102.  
  103.      IMPORTANT NOTE:  If this License or any portion thereof is not legally
  104.      valid  in  your  geographical  area  or  jurisdiction, THIS LICENSE IS
  105.      WITHDRAWN and YOU ARE NOT LICENSED TO USE OR DISTRIBUTE THE PACKAGE!  
  106.  
  107.      WARNING!  YOU USE THIS PACKAGE ENTIRELY AT YOUR OWN RISK!  The  author
  108.      will  NOT  be responsible for any loss of data, loss of business, loss
  109.      of monies or any other damages resulting from the use of, or inability
  110.      to use this  program.   By  operating  the  program,  you  accept  and
  111.      acknowledge responsibility IN FULL for all occurrences related to your
  112.      use  of  the  program.   In  any jurisdiction where such limitation of
  113.      liability is restricted or forbidden, this program IS NOT licensed for
  114.      legal use.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                        2
  131.                                   28-SEP-1991
  132.  
  133.  
  134.  
  135.      OTHER USES (NON-LICENSED USES) 
  136.  
  137.      Use and distribution outside the scope of the License Agreement  above
  138.      is  strictly  prohibited, unless prior, written permission is obtained
  139.      from  the  author.   Inquiries  may  be  directed  to:   SKS  Computer
  140.      Consulting, Inc., P.O.  Box 202350, Austin, TX, 78720, USA.  Include a
  141.      self-addressed, stamped envelope for replies.  
  142.  
  143.      DISTRIBUTION NOTICE 
  144.  
  145.      The  package  may  be  posted for download or file request by any FTSC
  146.      compliant system in archived form, and in adherence to  the  terms  of
  147.      the  License  above.  No profit may be realized directly or indirectly
  148.      from such distribution, although  the  package  may  be  provided  for
  149.      download on 'pay systems'.  
  150.  
  151.      ARCHIVES 
  152.  
  153.      The  regular  distribution  version  of  the package is archived using
  154.      PKZIP from PKWare, Inc.  This is NOT a  political  statement,  it's  a
  155.      matter of personal preference.  
  156.  
  157.      If  you  feel it necessary to re-archive the package in a format other
  158.      than the format it's delivered in, go ahead, but you should  read  the
  159.      License Agreement carefully.  Any distribution of the package requires
  160.      that ALL the files AS ORIGINALLY DISTRIBUTED must be included.  
  161.  
  162.      Prior  to  distribution,  make  certain that you have a full, original
  163.      version, and make sure all the files in the package make it into  your
  164.      new archive.  Addition of files to the distribution is prohibited.  
  165.  
  166.      PURCHASING COPIES OF THE PACKAGE 
  167.  
  168.      The  package  is also available on diskette within the USA and Canada.
  169.      Send check or money order in US dollars to:  SKS Computer  Consulting,
  170.      Inc., P.O.  Box 202350, Austin, TX, 78720, USA.  
  171.  
  172.      SOURCE CODE 
  173.  
  174.      Source  code to the package will not be available.  I do not feel that
  175.      I need to justify my reasoning.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                        3
  196.                                   28-SEP-1991
  197.  
  198.  
  199.  
  200.      PROGRAM OPERATION 
  201.  
  202.      LSTFMT provides 2 functions.  1).  The extraction of comments and  2).
  203.      Formatted  extraction  of  node  information   from   FTSC   compliant
  204.      nodelists.  
  205.  
  206.      The format for using LSTFMT is:  
  207.  
  208.      
  209.      LSTFMT /I<Input_file>
  210.             /O<Output_file>
  211.             /N<Net_number>
  212.             /S<System_info>
  213.             /Pazrtenscypbf
  214.             /K<zone>,<region>,<net>
  215.             /C[SUFAE]
  216.             /E<echo_area>,<host_zone>,<host_net>,<host_node>,
  217.               <your_zone>,<your_net>,<your_node>
  218.             /D
  219.             /R
  220.             /A
  221.             /T
  222.             /L
  223.  
  224.      Where  all arguments are entered on the same line interactively or via
  225.      a batch file.  
  226.  
  227.      /I<Input_file> 
  228.  
  229.           This is the nodelist file from which to extract the  information.
  230.           If  you  fail  to  specify  the  filename  extension, LSTFMT will
  231.           calculate the day number of the current nodelist and will attempt
  232.           to open  the  file  with  the  nodelist  day  as  the  file  name
  233.           extension.  If you do not use this switch, LSTFMT will attempt to
  234.           use  the  current expected NODELIST.### file.  In either of these
  235.           last 2 cases, if LSTFMT doesn't  find  a  list  for  the  current
  236.           expected  julian  date  for  the  nodelist,  it will look for the
  237.           previous weeks list.  
  238.  
  239.           You may specify any valid Drive:\directory\path\filename.ext.  
  240.  
  241.      Either one or both of these switches must be specified:  
  242.  
  243.      /N<Net_number> 
  244.  
  245.           This is the Zone, Region, or Host net from which to  extract  and
  246.           format  the  information.  LSTFMT will find the first match which
  247.           corresponds to the specified information.   So,  if  you  specify
  248.           /N1,  it  will  format all of the information for the first match
  249.           which will be all of  the  Zone  1  independent  nodes.   If  you
  250.           specify  /N10 you will receive a listing for all of the Region 10
  251.           independent nodes, etc.  Bear in mind that some Regions/Hosts may
  252.           be duplicated between Zones.  If you  want  to  extract  specific
  253.           information  for  a  particular  net  in a particular region in a
  254.           particular zone, you should probably use the /K switch.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                        4
  261.                                   28-SEP-1991
  262.  
  263.  
  264.  
  265.           If an '*' is specified as the net_number, then all  nets  in  the
  266.           input  nodelist will be formatted.  This parameter will supercede
  267.           the /S switch.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                        5
  326.                                   28-SEP-1991
  327.  
  328.  
  329.  
  330.      /C[sufae] 
  331.  
  332.           This  indicates  that  comments  should  be  extracted  from  the
  333.           nodelist input file.  Only comments with text following them will
  334.           be  extracted.   If no arguments are specified, all comments will
  335.           be extracted.  The valid comment types are S,U,F,A  and  E.   You
  336.           may  specify  any  combination  of  these   comment   types   for
  337.           extraction.  
  338.  
  339.      /O<Output_file> 
  340.  
  341.           Is  the file to which the extracted information is to be written.
  342.           This file does not have to exist, but it will be created  in  the
  343.           same directory as LSTFMT if it does not exist.  
  344.  
  345.           You may specify any valid Drive:\directory\path\filename.ext.  
  346.  
  347.           If  this  switch is not specified, the output will be sent to the
  348.           system terminal (console).  
  349.  
  350.           If the <Output_file> cannot be opened, or if none  is  specified,
  351.           then the output will be sent to the system terminal (console).  
  352.  
  353.           *WARNING*  If  the  file <Output_file> exists, it will be deleted
  354.           and the current output from LSTFMT will be directed  to  the  new
  355.           file.   Refer to the use of the /A switch for appending output to
  356.           existing files.  
  357.  
  358.      /S<System_info> 
  359.  
  360.           This is specific system information that LSTFMT is to search  for
  361.           and  extract  to  the  output file.  This may be any text string.
  362.           Each   system  found  which  contains  this  information  in  the
  363.           input_file will be formatted and  written  to  the  output  file.
  364.           This may be system name, sysop name, baud rate, etc.  
  365.  
  366.           If no /N net number is specified, all Zones, Regions and Hosts in
  367.           the  input  file  will  be  searched.   If  a  /N  net  number is
  368.           specified, only that net will be searched for this information.  
  369.  
  370.           *NOTES* The actual <System_info>  string  searched  for  is  case
  371.           insensitive.   That means you can use any combination of upper or
  372.           lower case letters and you will get the same results.  
  373.  
  374.           Also, using the /T switch may cause the output to be formatted in
  375.           such a way so that the text searched for may not  be  written  to
  376.           the output file.  
  377.  
  378.      /T 
  379.  
  380.           This  indicates  that  the /Net output should be formatted for 80
  381.           columns.  This is handy if you wish to use the  output  file  for
  382.           display via a B)ulletins Menu item.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                        6
  391.                                   28-SEP-1991
  392.  
  393.  
  394.  
  395.      /L 
  396.  
  397.           This  indicates  that  the output should be formatted for labels.
  398.           The output is directed to the  device/file  specified.   This  is
  399.           really  a  'down  and  dirty' label program.  All that it does is
  400.           output 3 lines to the output device/file.  Each line is  preceded
  401.           with  the  Epson double wide character (hex) 0E, and each line is
  402.           separated by a blank line.   The  spacing  is  designed  for  the
  403.           labels  which  are  3-1/2 x 15/16 in size.  The 3 lines generated
  404.           are:  1).  SysOp name, 2).  System name  and  3).   Node  number.
  405.           The  3  lines are centered, based on this label size.  Note, that
  406.           these labels can only handle  about  18  double  wide  characters
  407.           across.   So  any lines which would be greater than 18 lines will
  408.           run off the end of the label.  If you direct the output to a file
  409.           rather than the printer, you will have an opportunity to manually
  410.           edit  these  lines.   This  will  give  you  the  opportunity  to
  411.           abbreviate  the  spelling  if  you  wish.   A  sample label is as
  412.           follows:  
  413.  
  414.                          Steve Shapiro
  415.  
  416.                          LoneStar CBCS
  417.  
  418.                             382/35
  419.  
  420.           (of course, on the  label  they  would  be  double  wide).   This
  421.           functionality  is  handy  if  you wish to use the output file for
  422.           display via a B)ulletins Menu item.   The  purpose  for  which  I
  423.           developed  this  functionality is so that we had some simple name
  424.           tags   for   our   Net382   pizza  parties.   It  simplified  the
  425.           introductions as well as automated the generation  of  the  list.
  426.           Our  NPC  (Net  Pizza  Coordinator)  used  to  have to type it in
  427.           manually.  
  428.  
  429.      /A 
  430.  
  431.           This switch indicates that the output is to be  appended  to  the
  432.           output  file if it exists, rather than deleting the existing file
  433.           first.  If  the  file  specified  does  not  exist,  it  will  be
  434.           created.  
  435.  
  436.      /R 
  437.  
  438.           This  switch  allows  for RAW nodelist output.  If specified, the
  439.           output will not be formatted for display purposes.   This  switch
  440.           overrides the /T switch.  
  441.  
  442.      /D 
  443.  
  444.           This  switch will result in a comma delimited list being produced
  445.           which may be used for input into the CVTFON program  (written  by
  446.           Steve  Linhart).   CVTFON  is  a  program  which  will  produce a
  447.           telephone   dialing  directory  for  most  of  the  popular  comm
  448.           programs.  For example, the commands:  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.                                        7
  456.                                   28-SEP-1991
  457.  
  458.  
  459.  
  460.           lstfmt /inodelist /ofidonet.cvl /k1,19 /d 
  461.           if exist fidonet.cvl cvtfon fidonet.cvl=comma fidonet.fon=telix 
  462.  
  463.           will produce a comma delimited list for all of Zone 1, Region  19
  464.           and  place  it in the file FIDONET.CVL.  CVTFON is then run using
  465.           FIDONET.CVL as input, and FIDONET.FON as output.  The FIDONET.FON
  466.           file produced is for use with the  Telix  Communications  program
  467.           produced by Exis, Inc.  
  468.  
  469.           Additional FON file support:  
  470.  
  471.           There  is  a  program  written  by  Henry  Clark of 1:124/6120 in
  472.           Dallas, Tx.  called FONDIR.  FONDIR  is  a  BBS  List  conversion
  473.           utility  which  uses textual BBS lists as input and produces .FON
  474.           files for comm programs.  However, FONDIR does NOT support  comma
  475.           delimited  files as input for conversion.  So, to use LSTFMT with
  476.           FONDIR this is what you do:  
  477.  
  478.           First create a text file named FONDIR.TPL containing the text:  
  479.  
  480.           +-------------column 1
  481.           |             +--------column 28
  482.           |             |        +---column 43
  483.           |             |        |
  484.           V             V        V
  485.           |n25          |#14     |p4
  486.  
  487.           Then create a batch file:  
  488.  
  489.           LSTFMT /INODELIST /OTEXTLIST.TXT /N382 /PSPB 
  490.           copy fondir.tpl+textlist.txt textlist.inp 
  491.           fondir textlist.inp /o:t 
  492.  
  493.           Then when you run the batch file you will get a TELIX.FON file.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.                                        8
  521.                                   28-SEP-1991
  522.  
  523.  
  524.  
  525.  /E<echo_area>,<host_zone>,<host_net>,<host_node>,
  526.    <your_zone>,<your_net>,<your_node>
  527.  
  528.      Note:  while I have split this into 2 lines, it is neccessary that  it
  529.      all appear on the same line 
  530.  
  531.           This  switch  will  cause  LSTFMT  to create an output file which
  532.           conforms to the FTSC definition for a mail packet.  A packet  and
  533.           message  header  are  created,  and  the  message,  which  is the
  534.           extracted output, is appended.  
  535.  
  536.           All arguments are required.  
  537.  
  538.           The MAXIMUM length of the net/node number is 5 characters.   FTSC
  539.           only  requires  up  to 4 characters for these numbers, but I have
  540.           noticed that  some  people  use  special  net/node  numbers  when
  541.           dealing with their point systems.  If you use numbers longer than
  542.           5 characters,  the  results will be inconsistent and you get what
  543.           you deserve.  
  544.  
  545.           The echo_area is the echo area in which  the  message  is  to  be
  546.           tossed.   This  area  name may be in upper or lowercase as LSTFMT
  547.           will convert it to uppercase.  If the  area  specified  does  not
  548.           exist,  the  message  will be handled based on the mailer program
  549.           you are using.  ie:  Confmail and Qmail will toss  it  into  your
  550.           bad_messages area.  
  551.  
  552.           The  host_zone,  host_net and host_node is the zone, net and node
  553.           number of your 'parent' node, ie:  if you are a node, it would be
  554.           your hub, if you are a hub, it would be your host, etc.   If  you
  555.           only  want the message sent to your subordinate nodes, then enter
  556.           your node number.  
  557.  
  558.           The your_zone, your_net and your_node is your zone, net and  node
  559.           number.  
  560.  
  561.           LSTFMT  will automatically calculate the filename for the packet.
  562.           However, LSTFMT also  needs  to  know  where  your  inbound  mail
  563.           directory  is  located.  To do this it uses the /O specification.
  564.           If the /O switch is blank or omitted, it will place the packet in
  565.           the   current  directory.   If  the  /O  switch  does  specify  a
  566.           drive:directory\path string, it must be terminated with  a  final
  567.           backslash '\', ie:  c:\inbound\.  
  568.  
  569.      /K<zone>,<region>,<net> 
  570.  
  571.           This  switch  will  cause  LSTFMT  to produce a shrunK, or pruned
  572.           NODELIST file which may be used as  input  to  such  programs  as
  573.           Parselst or Xlatlst.  LSTFMT does not attempt to provide the same
  574.           kind  of  versatility  as  is  available  with  programs  such as
  575.           ShrinkNl or Prune.  The intended purpose of this  feature  is  to
  576.           produce  a  list for the SysOp who only wishes to have a nodelist
  577.           which is comprised of  his  local  net,  or  a  small  number  of
  578.           specific  nets.   This  switch  overrides  the  /P,  /T  and   /R
  579.           switches.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.                                        9
  586.                                   28-SEP-1991
  587.  
  588.  
  589.  
  590.           This switch supports 3 required parameters.  They are:  
  591.  
  592.           1.   Zone - Your zone of interest, ie:  1,2,3,99, etc.  
  593.           2.   Region - Your region of interest, ie:  10,11,19, etc.  
  594.           3.   Net - Your net of interest, ie:  142,256,382,9100, etc.  
  595.  
  596.           These  parameters  must  be  in the order indicated.  LSTFMT will
  597.           attempt to do some minor error checking, but  the  burden  is  on
  598.           YOU.  It will merely make sure that before it encounters the NET,
  599.           it  has found the REGION, and before it finds the REGION, that it
  600.           has found the ZONE.  It  will  print  an  error  message  on  the
  601.           terminal if these conditions are not satisfied, or if it does not
  602.           find the NET.  
  603.  
  604.           Each  parameter  is  optional.   If you do not specify any Zones,
  605.           Regions or Nets, then LSTFMT will ignore  this  switch.   If  you
  606.           omit  the  Region and Net number, then LSTFMT will produce a list
  607.           containing ALL nodes in ALL Nets  in  ALL  Regions  in  the  Zone
  608.           specified.   If you omit the Net number, then LSTFMT will produce
  609.           a list containing ALL nodes in ALL Nets in the Region specified.  
  610.  
  611.           A note on regional independent nodes.  If the number you  specify
  612.           as  the  HOST  is  actually a regional independent node, then you
  613.           will receive a listing for just that node, rather than an  entire
  614.           list of nodes under a host.  
  615.  
  616.           Bear  in mind, even if you specify valid Zones, Regions and Nets,
  617.           it may still be wrong.  For  example,  if  you  specify  Zone  1,
  618.           Region  20  and Net 632, these are all valid parameters, and they
  619.           are in the proper sequence in the nodelist, but Region 20  is  in
  620.           zone 2 and Net 632 is in Zone 3.  
  621.  
  622.           By  combining  various  switches,  you  can produce a multizone /
  623.           multinet nodelist  with  only  the  nets  of  your  choice.   For
  624.           example, if you are a member of FidoNet, EggNet and AlterNet, you
  625.           could  produce  a  file  which contains information with all 3 of
  626.           your local nets included into a single nodelist.  
  627.  
  628.           One special note, depending on the nodelist  processor  you  use,
  629.           you  may  have  to  use  the  Version  5 nodelist switch when you
  630.           process the nodelist and/or when you use your BBS software.   ie:
  631.           Binkley has a NewNodelist parameter so you would not use it.  
  632.  
  633.           This switch supercedes the /N, /S, /P, /T and /R switches.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                                        10
  651.                                   28-SEP-1991
  652.  
  653.  
  654.  
  655.      /Pazrtenscypbf 
  656.  
  657.           This switch allows for POSITIONAL nodelist output.  If specified,
  658.           the  output  will be positionally formatted for display purposes.
  659.           This switch overrides the /T switch and the /R switch.  
  660.  
  661.           The fields to be output are  specified  via  the  argument  list.
  662.           These are:  
  663.  
  664.           1.   A -  Address.   This is a fully qualified network address of
  665.                the form zone:net/node.  The field width  is  14  characters
  666.                wide.  
  667.           2.   Z - Zone.  The field width is 4 characters wide.  
  668.           3.   R - Region.  The field width is 6 characters wide.  
  669.           4.   T - Net.  The field width is 7 characters wide.  
  670.           5.   E -  Type, ie:  any information such as HOST, HUB, etc.  The
  671.                field width is 7 characters wide.  
  672.           6.   N - Node number.  The field width is 5 characters wide.  
  673.           7.   S - System name.  The field width is 25 characters wide.  
  674.           8.   C - City.  The field width is 25 characters wide.  
  675.           9.   Y - sYsop name.  The field width is 21 characters wide.  
  676.           10.  P - Phone.  The field width is 16 characters wide.  
  677.           11.  B - Baud.  The field width is 5 characters wide.  
  678.           12.  F - Flags.  The field width is 25 characters wide.  
  679.  
  680.           If the data for any field is larger than  the  field  width,  the
  681.           data is truncated so that the information may be formatted in the
  682.           specified widths.  
  683.  
  684.           The  output  is formatted in the order in which it appears in the
  685.           list.  So, if you specify /Pnyp, LSTFMT will  format  the  output
  686.           as:   Node  number,  SysOp name and Phone number.  If you specify
  687.           /Pycpb, LSTFMT will format the  output  as:   SysOp  name,  City,
  688.           Phone number and Baud rate.  
  689.  
  690.           It is possible to use each field qualifier more than once, but no
  691.           more than 7 total may be used.  
  692.  
  693.  
  694.      These switches may be in any order and may be in either upper or lower
  695.      case.  They must be separated by a space.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                        11
  716.                                   28-SEP-1991
  717.  
  718.  
  719.  
  720.      EXAMPLES:  
  721.  
  722.      1).  LSTFMT /inodelist.307 /oadmin1.lst /n1 
  723.  
  724.      LSTFMT  would  use the file NODELIST.307 as input.  It will create the
  725.      output file ADMIN1.LST.  It will search NODELIST.307  for  the  Zone,1
  726.      administrative  information and format the output for each node in the
  727.      net and write it to the file ADMIN1.LST.  
  728.  
  729.      2).  LSTFMT /N382 /Inodelist /Onet382.lst /T 
  730.  
  731.      LSTFMT would determine that the file  NODELIST  does  not  exist.   It
  732.      would  then  calculate  the expected day of the current nodelist.  For
  733.      our examples, this would be day 307.   It  would  then  use  the  file
  734.      NODELIST.307  as  input.   It  will  then  create  the   output   file
  735.      NET382.LST.   It  will search NODELIST.307 for Host,382 and format the
  736.      output for each node in the net and write it to the  file  NET382.LST.
  737.      The text will be written in 80 column format.  
  738.  
  739.      3).  LSTFMT /oLIST307.CMT /iNODELIST.307 /c 
  740.  
  741.      LSTFMT  would  use the file NODELIST.307 as input.  It will copy every
  742.      comment line from the input file into the output file.  
  743.  
  744.      4).  LSTFMT /N2 /Inodelist.307 /csa /Onetz2.lst /T 
  745.  
  746.      LSTFMT would use the file NODELIST.307 as input.  It will  create  the
  747.      output  file  NETZ2.LST.   It  will search NODELIST.307 for Zone,2 and
  748.      format the output for each administrative node in the zone  and  write
  749.      it  to  the  file  NETZ2.LST.   The  text will be written in 80 column
  750.      format.  Only the ;S and ;A comments from the input nodelist  will  be
  751.      witten to the output file.  
  752.  
  753.      *NOTE* The comments section is ALWAYS written to the output file prior
  754.      to its writing the net information section to the output file.  
  755.  
  756.      5).  LSTFMT /N9100 /IEGGlist.LST /c /OEGG9100.lst /s9600 
  757.  
  758.      LSTFMT  would  use  the file EGGLIST.LST as input.  It will create the
  759.      output file EGG9100.LST.  It will then search the input file  for  all
  760.      of  the  comments.   Once  done,  it  will  search all of the nodes in
  761.      NET9100 for the text string 9600 and write each node  which  qualifies
  762.      to the output file.  
  763.  
  764.      6).  LSTFMT /N* /IEGGlist.LST /c /OALLEGG.lst /s9600 
  765.  
  766.      LSTFMT  would  use  the file EGGLIST.LST as input.  It will create the
  767.      output file ALLEGG.LST.  It will then search the input file for all of
  768.      the comments and write them to the output file.  Once  done,  it  will
  769.      format  and write the information for each node in the nodelist to the
  770.      output file.  The  /s9600  switch  is  ignored  since  it  is  already
  771.      formatting  the output for every node in the list.  The output will be
  772.      in 132 column format since the /T switch is not specified.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.                                        12
  781.                                   28-SEP-1991
  782.  
  783.  
  784.  
  785.      7).  LSTFMT /IEGGlist.LST /c /Ob:\EGG9100.lst /s9600 
  786.  
  787.      LSTFMT would use the file EGGLIST.LST  in  the  current  directory  as
  788.      input.   It  will  create  the  output  file  EGG9100.LST  in the root
  789.      directory of drive B:.  It will then search the input file for all  of
  790.      the  comments.   Once  done, it will search all of the nodes in ALL of
  791.      the nets for the text string 9600 and write each node which  qualifies
  792.      to the output file.  
  793.  
  794.      8).  LSTFMT /N382 /Inodelist /c /Oallnet.lst /T 
  795.           LSTFMT /IEGGlist.LST /c /oallnet.lst /n9100 /a
  796.  
  797.      LSTFMT  would  use  the file NODELIST.307 as input (it would calculate
  798.      the   307  automatically).   It  will  then  create  the  output  file
  799.      ALLNET.LST.  It will then  search  the  input  file  for  all  of  the
  800.      comments.   Once  done, it will search for all of the nodes in net382.
  801.      It will format the node information for 80 column output.  
  802.  
  803.      With the execution of the second command, LSTFMT would  use  the  file
  804.      EGGLIST.LST  as  input.  Upon finding the file ALLNET.LST to exist, it
  805.      would append all of the comments found in the EGGLIST.LST file to  the
  806.      output file.  It would then search for all of the nodes in net9100 and
  807.      write it to the output file formatted for 132 column output.  
  808.  
  809.      9).  LSTFMT /N382 /Inodelist.307 /c /O /T 
  810.  
  811.      LSTFMT  will  use  the  file  NODELIST.307 as input.  It will send the
  812.      output to the system terminal (console).  It will produce  a  list  of
  813.      the  comments  and a list of all nodes in NET 382.  The output will be
  814.      formatted for 80 columns.  
  815.  
  816.      10).  LSTFMT /N382 /Ia:\list\nodelist.307 /c /O /T /R 
  817.  
  818.      LSTFMT will use the  file  NODELIST.307  on  drive  A:   in  the  LIST
  819.      subdirectory as input.  It will send the output to the system terminal
  820.      (console).   It  will produce a list of the comments and a list of all
  821.      nodes in NET 382.  The output will look just like it does in  the  raw
  822.      nodelist.  
  823.  
  824.      11).  LSTFMT /N382 /Ilist\nodelist.307 /c 
  825.  
  826.      LSTFMT  will  use  the  file  NODELIST.307  which  is  in   the   LIST
  827.      subdirectory as input.  It will send the output to the system terminal
  828.      (console).   It  will produce a list of the comments and a list of all
  829.      nodes in NET 382.  The output will be formatted for 132 columns.  
  830.  
  831.      12).  LSTFMT /N382 /PNSCY 
  832.  
  833.      LSTFMT will choose NODELIST.307 for the input  file.   The  /P  switch
  834.      activates  the  positional  output  formatting.   The  output  will be
  835.      formatted as:  Node number, System name, City and SysOp name.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                                        13
  846.                                   28-SEP-1991
  847.  
  848.  
  849.  
  850.      13).  LSTFMT /inodelist /oshrnklst.lst /k1,19,382 
  851.  
  852.      LSTFMT will choose the current nodelist.  It will create a shrunk list
  853.      file for Zone 1, Region 19, Net 382.  The output will be  placed  into
  854.      the file SHRNKLST.LST in the current directory.  
  855.  
  856.      14).  LSTFMT /onodelist.lst /k1,19,382 /t /n383 /psny 
  857.  
  858.      LSTFMT will choose the current nodelist.  It will create a shrunk list
  859.      file  for  Zone 1, Region 19, Net 382.  The output will be placed into
  860.      the file SHRNKLST.LST in the current directory.  The  /T,  /N  and  /P
  861.      information is ignored.  
  862.  
  863.      15).  LSTFMT /inodelist /omultilst.lst /k1,19,382 
  864.            LSTFMT /iegglist.lst /omultilst.lst /k99,912,9100 /a
  865.            LSTFMT /inetlist.lst /omultilst.lst /k8,71,7102 /a
  866.  
  867.      LSTFMT  will use the current NODELIST to produce a shrunk list for all
  868.      of the nodes in FidoNet Net382.   It  will  then  use  EGGLIST.LST  to
  869.      produce  a  shrunk  list  for  all  of the nodes in EggNet Net9100 and
  870.      append it to that of Net382.  It will then use NETLIST.LST to  produce
  871.      a shrunk list of all of the nodes in NetWork Net7102, and append it to
  872.      that of Net382 and Net9100.  
  873.  
  874.      The  output  file can then be used for multizone processing for all of
  875.      the nets you belong to in your local area.  
  876.  
  877.      16).  LSTFMT /Inodelist /onetslist.lst /k1,19 
  878.  
  879.      LSTFMT will use the current NODELIST to produce a shrunk list for  all
  880.      of  the  nodes  in  all  of  the Nets in all of the Regions in FidoNet
  881.      Region 19.  
  882.  
  883.      17).  LSTFMT /Inodelist /N382 /t /Elocal-sysop,1,382,1,1,382,35 
  884.  
  885.      LSTFMT will use the current NODELIST to  produce  an  echomail  packet
  886.      file of all the nodes in Net382 in an 80 column format.  It will place
  887.      this packet file in the current directory.  
  888.  
  889.      18).  LSTFMT /N382 /t /Elocal-sysop,1,382,1,1,382,35 /Oc:\inbound\ 
  890.  
  891.      LSTFMT  will  use  the  current NODELIST to produce an echomail packet
  892.      file of all the nodes in Net382 in an 80 column format.  It will place
  893.      this packet file in the c:\inbound directory.  When processed, it will
  894.      be tossed into the LOCAL-SYSOP echo and sent upwards to  the  host  at
  895.      382/1 as well as to any nodes who I feed this echo to.  
  896.  
  897.      19).  Lstfmt /inodelist /ofidonet.cvl /k1,19 /d 
  898.  
  899.      LSTFMT will use the current NODELIST to produce a comma delimited list
  900.      for all of Zone 1, Region 19 and place it in the file FIDONET.CVL.  
  901.  
  902.      If you have the program CVTFON by Steve Linhart, then you may use this
  903.      command:  
  904.  
  905.      if exist fidonet.cvl cvtfon fidonet.cvl=comma fidonet.fon=telix 
  906.  
  907.  
  908.  
  909.  
  910.                                        14
  911.                                   28-SEP-1991
  912.  
  913.  
  914.  
  915.      CVTFON  is  then  run  using  FIDONET.CVL as input, and FIDONET.FON as
  916.      output.  The FIDONET.FON file produced  is  for  use  with  the  Telix
  917.      Communications program produced by Exis, Inc.  
  918.  
  919.      20).  LSTFMT /inodelist /onet382.lab /l /n382 
  920.  
  921.      LSTFMT  will  use  the  current  NODELIST to produce an output file in
  922.      Epson label format for all nodes in Net 382.  
  923.  
  924.  
  925.      That's all there is to it.  
  926.  
  927.      If you have any ideas for enhancements,  modifications,  improvements,
  928.      etc.   feel  free and encouraged to contact me.  You won't receive any
  929.      monetary remuneration, but you may find yourself receiving  credit  in
  930.      the documentation.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.                                        15
  976.                                   28-SEP-1991
  977.  
  978.  
  979.  
  980.      HISTORY 
  981.  
  982.      v1.00 11/06/1989 
  983.  
  984.      This is the initial release of LSTFMT.  
  985.  
  986.      v1.10 11/12/1989 
  987.  
  988.      Thanks  to Jim Westbrook of 1:382/29 for this suggestion.  You can now
  989.      specify a Zone or Region number in addition to a Host number.  
  990.  
  991.      v1.20 11/15/1989 
  992.  
  993.      Thanks again to Jim Westbrook for his  suggestions.   Thanks  also  to
  994.      Larry  Mundy  of  1:170/400  and  Bruce Bodger of 1:124/1003 for their
  995.      ideas.  
  996.  
  997.      Features added to this version:  
  998.  
  999.      1.   Each input parameter is specified by individual switches.  
  1000.      2.   Some parameters are optional.  Some features can be combined.  
  1001.      3.   Support for 80 column output as well as 132 column output.  
  1002.      4.   The ability to search for user specified text strings.  
  1003.      5.   The ability to determine the day of the current nodelist for  use
  1004.           with input filename specifications.  
  1005.      6.   Only comments with S,U,F,A or E encoding is supported.  
  1006.      7.   Added the capability to append output to an existing file.  
  1007.  
  1008.      v1.30 11/18/1989 
  1009.  
  1010.      First  rampant  bug.   The  default  nodelist date algorithm had a bug
  1011.      which didn't give the correct nodelist day if you attempted to run  it
  1012.      on  Saturday  or  Sunday.  I guess it didn't like working weekends any
  1013.      more than I do.  
  1014.  
  1015.      v1.40 12/15/1989 
  1016.  
  1017.      1.   Eliminated   any  ability  for  users  to  specify  an  alternate
  1018.           dir:\path string or wildcards in the  input  or  output  filename
  1019.           specification.  
  1020.  
  1021.      2.   Added  /N*  option  for specifying ability to format list for all
  1022.           nodes in the nodelist.  
  1023.  
  1024.      3.   Thanks to Charles Falconer  of  1:141/209.1  for  his  suggestion
  1025.           regarding  the  /O  switch.   LSTFMT will now default to terminal
  1026.           (console) output if the output file is not specified,  or  if  it
  1027.           cannot open the output file.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.                                        16
  1041.                                   28-SEP-1991
  1042.  
  1043.  
  1044.  
  1045.      v1.50 01/28/1990 
  1046.  
  1047.      1.   Added the /R switch for raw output capability.  Thanks to William
  1048.           Collins for this suggestion.  
  1049.  
  1050.      2.   Fixed minor bug.  If the user created an excerpted version of the
  1051.           nodelist  and  ran LSTFMT, there were some circumstances where it
  1052.           would output a duplicate of the last line in the file.  Thanks to
  1053.           William Collins of for finding this bringing it to my attention.  
  1054.  
  1055.      v1.60 02/18/1990 
  1056.  
  1057.      1.   Added the /P switch for positional output capability.  Thanks  to
  1058.           William Collins for this suggestion.  
  1059.  
  1060.      2.   Eliminated  the  need  for  the  /I  flag.   If  no input file is
  1061.           specified, then LSTFMT will look  for  the  current  NODELIST.###
  1062.           file in the current directory.  
  1063.  
  1064.      3.   Added  Drive  and  Path  support  for  both  the Input and Output
  1065.           files.  Thanks to almost everyone in  the  net  who  wanted  this
  1066.           feature.  
  1067.  
  1068.      4.   Added  capability  to  produce  a ShrunK nodelist.  Thanks to Jim
  1069.           Westbrook of 1:382/29 for this suggestion.  
  1070.  
  1071.      v1.70 04/02/1990 
  1072.  
  1073.      1.   Modified the /C switch.  Now the user may specify  which  of  the
  1074.           comments to include into the output.  
  1075.  
  1076.      2.   Added  the /E switch to allow the user to toss the output into an
  1077.           echo area for netwide  distribution.   Special  thanks  to  Kelly
  1078.           Drown  who  provided  some  data  structures   for   the   packet
  1079.           description.  
  1080.  
  1081.      3.   Added  the  /D  switch  to  allow  the  user  to  produce a comma
  1082.           delimited file which may be used as input to the  CVTFON  program
  1083.           by Steve Linhart.  
  1084.  
  1085.      4.   Modified  the /K switch so that independent regional nodes may be
  1086.           explicitly extracted.  
  1087.  
  1088.      v1.80 11/01/1990 
  1089.  
  1090.      1.   Added the /L switch.  Now you may produce name labels  for  those
  1091.           Net Togethers and pizza parties.  Thanks to Bill Degnan of 382/39
  1092.           for this suggestion.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                        17
  1106.                                   28-SEP-1991
  1107.  
  1108.  
  1109.  
  1110.      v1.90 07/14/1991 
  1111.  
  1112.      Maintenance release.  
  1113.  
  1114.      1.   Updated the docs for greater clarity.  
  1115.      2.   Added ability to specify the zone number for the /E parameter.  
  1116.  
  1117.      v2.00 07/24/1991 
  1118.  
  1119.      1.   Revised the way in which <FF> form-feeds are utilized.  Thanks to
  1120.           Richard Holler of 1:231/290 for this suggestion.  
  1121.  
  1122.      v2.10 09/10/1991 
  1123.  
  1124.      1.   Revised some internal algorithms to speed things up a bit.  
  1125.      2.   Compressed  .EXE  file  with  PKLite  v1.12 and gained a 50% size
  1126.           reduction.  If you experience problems or difficutlties,  contact
  1127.           me ASAP so that I can determine if PKLite caused the problem.  
  1128.  
  1129.      v2.20 09/21/1991 
  1130.  
  1131.      1.   Added the AZRTE positional qualifiers for the /P switch.  
  1132.      2.   If  a node is the net host, the node number is converted from the
  1133.           net number itself to a zero for printing.  ie:   a  line  of  the
  1134.           form:  
  1135.  
  1136.           Host,382,,,,etc.  
  1137.  
  1138.           Would be displayed as 1:382/0 in the formatted output.  
  1139.      3.   All  formatted  listings  now display the full network address in
  1140.           the form of zone:net/node.  
  1141.      4.   Added functionality so that if LSTFMT cannot  find  the  nodelist
  1142.           for  the  current  week,  it  will  try  to  find the one for the
  1143.           previous week.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.                                        18
  1171.  
  1172.